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A Rectangle Class 



Example 2-1 shows a class that represents a rectangle. Each instance of this i Re ct 
class has four fields, xl, yl. x2, and y2, that define the coordinates of the comas 
of the rectangle. The Rect dass also defines a number of methods that operate on 
those coordinates. 

Note the toStringO method. This method overrides the toStringO method of 
java.lang. Object, which is the implicit superclass of the Rect class. toStringO 
produces a String that represents a Rect object. As youll see, this method is quite 
useful for printing out Rect values. 

Example 2-1: Reetjaua 

package cont.davtdflanagan. examples. classes; 
/** 

* This class represents a rectangle. Its fields represent the coordinates 

* of the comers of the rectangle. Its methods define operations that can 

* be performed on Rect objects. 
**/ 

public class Rect t 

// These are the data fields of the class 
public int xl, yl. x2, yl: 

/*• 

* The 1s the main constructor for the class. It slnply uses Us arguments 

* to Initialize each of the fields of the new object. Note that 1t has 

* the sawe name is the class, and that U has no return value declared 1n 

* Us signature. 
**/ 

public Rectttnt xl, 1nt yl. int x2. 1nt y2) I 
thls.xl = xl; 
thls.yl « yl; 
this.x2 - x2; 
thls.yZ = y2: 

> 

* This 1s another constructor. It defines Itself In terms of the above 
*•/ 

public Rect tint width, int height) ( thlstO. 0. width, height); ) 

/** This 1s yet another constructor. */ 
public RectO ( thlsCO, 0. 0. 0); > 

/*♦ Hove the rectangle by the specified aoounts */ 
public void move (int deltux. int deltay) { 

xl delUx; x2 del tax; 

yl -ki deltay; y2 deltay; 

) 

/'** lest whether the specified point is Inside the rectangle V 
public boolean islnsidednt x, int yl { 

return [(x >= xl) U (x «= x2) && (y >= yl) «A (y y 2)) ; 

) 



* Return the union of this rectangle with another. I.e. return the 

* smallest rectangle that includes then both. 
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Example 2-1: Fectjtwa (continued) 
**/ 

public Rect union(Rect r) { 

return new Rect((tMs.xi < r.xl) 
(this.yl < r.yl) 
(this.x2 > r.x2) 
(tMs.yZ > r.y2) 

> 



thfs.xl 
this.yl 
this.x2 
this.y2 



r.xl. 
r.yl. 
r.x2, 
r.y2): 



* Return the intersection of this rectangle with Mother. 

* I.e. return their overlap. 
**/ 

public Rect Intersect ion( Rect r) { 

Rect result = new RectCUhis.xl > r.xl) ? tMs.xl : r.xl, 

(this.yl > r.yl) ? this.yl : r.yl. 

<th1s.x2 < r.*2) T th1s.x2 : r.xZ. 

(this.y2 < r.y2) ? thij.y2 : r.y2); 
if (result. xl > result. x2) { result. *1 « result. x2 = 0; ) 
if (result. yl > result.y2) { result. yl = result. y2 ■ 0; 1 
return result; 

) 
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* This is a method of our superclass, Object. Me override It so that 

* Rect objects can be meaningfully converted to strings, can be 

* concatenated to strings with the + operator, and can be passed to 

* methods like Systea.out .prtntlnO 
**/ 

public String toStringO { 

return "I" + xl + \" + yl + " + x2 + \* + y2 ♦ 

> 



pat 



put 



Testing the Rect Class 

Example 2-2 is a standalone program named RectTest that puts the Rect class of 
Example 2-1 through its paces. Note the use of the new keyword and the Recti ) 
constructor to create new Rect objects. The program uses the . operator to Invoke 
methods of the Rect objects and to access their fields. The test program also relies 
implicitly on the toStr1ng( ) method of Rect when it uses the string concatenation 
operator (+) to create strings to be displayed to the user. 

Example 2-2: ReaTestjava 

package com. davidflanagan.examples. classes; 

/** This class demonstrates how you might use the Rect class V 
public class RectTest < 

public static void roaintStritigt] args) < 
. Rect rl * new Recttl. 1,4.4): // Create Rect objects 
Rect r2 » new Rect (2, 3, S. 6); 

Rect u * rl.unfon(r2); // Invoke Rect aethods 

Rect i - r2.intersect1on(rl); 

if (u.1sln$1de(r2.xl, r2.yl]> // Use Rect fields and invoke a method 
Systea.out.println("(" + r2.xl ♦ \" + r2.yl ♦ 
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Example 2-4: ColoredRectjava 

package com.da*1dflanagan. examples, classes; 
Inpart Java.awt.*; 

/** 

* This class subclasses OrawableRect and adds colors to the rectangle It draws 
**/ 

public class ColoredRect extends OrawableRect { 
// These are new fields defined by this class. 

// xl, yl. *2. and yl are inherited from our super-superclass, Rect. 
protected Color border, fill; 

/** 

* This constructor uses superO to Invoke the superclass constructor, and 

* also does some Initialization of Its own. 
**/ 

public ColoredRectUnt xl. int yl. int x2, 1nt y2, 
Color border. Color fill) 



{ 



superUL, yl, x2, y2); 
this. border = border; 
this.fill «* ftil ; 



* This method overrides the drawt) method of our superclass so that it 

* can make use of the colors that have teen specified. 
**/ 

public void draw (Graphics g) ( 
g.setColor(fill): 

g.flllRecttxl. yl, <x2-xl), Cy2-yl>); 

g.setCol or (border): 

g.drawRecUxl. yl. (x2-xl), (y2-yl»; 

) 



Complex Numbers 

Example 2-5 shows the definition of a class that represents complex numbers. You 
may recall from algebra class that a complex number is the sum of a real number 
and an imaginary number. The imaginary number i is the square root of -1. This 
Cotnpl exNumber dass defines two do Lib 1 e fields, which represent the real and imagi- 
nary parts of the number. These fields are declared private, which means they 
can be used only within the body of the class; they are inaccessible outside the 
class. Because the fields are inaccessible, the class defines two accessor methods, ! 
real ( ) and imaginary* ), that simply return their values. This technique of making 
fields private and defining accessor methods is called encapsulation. Encapsula- 
tion hides the implementation of a class from its users, which means that you can : 
change the implementation without it affecting the users. 

Notice that the Compl exNumber class doesn't define any methods, other than the 
constructor, that set the values of its fields. Once a Cotnpl exNumber object is cre- 
ated, the number it represents can never be changed. This property is known as 
immutability, it is sometimes useful to design objects that are immutable like this. j 
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